home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / OpenGL / glxchoosevisual.z / glxchoosevisual
Encoding:
Text File  |  2001-04-17  |  31.2 KB  |  397 lines
  1.  
  2.  
  3.  
  4. ggggllllXXXXCCCChhhhoooooooosssseeeeVVVViiiissssuuuuaaaallll((((3333GGGG))))         OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee ---- GGGGLLLLXXXX         ggggllllXXXXCCCChhhhoooooooosssseeeeVVVViiiissssuuuuaaaallll((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllXXXXCCCChhhhoooooooosssseeeeVVVViiiissssuuuuaaaallll - return a visual that matches specified attributes
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      XVisualInfo * ggggllllXXXXCCCChhhhoooooooosssseeeeVVVViiiissssuuuuaaaallll( Display *_d_p_y,
  14.                                     int _s_c_r_e_e_n,
  15.                                     int *_a_t_t_r_i_b_L_i_s_t )
  16.  
  17.  
  18. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  19.      _d_p_y         Specifies the connection to the X server.
  20.  
  21.      _s_c_r_e_e_n      Specifies the screen number.
  22.  
  23.      _a_t_t_r_i_b_L_i_s_t  Specifies a list of boolean attributes and integer
  24.                  attribute/value pairs.  The last attribute must be NNNNoooonnnneeee.
  25.  
  26. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  27.      ggggllllXXXXCCCChhhhoooooooosssseeeeVVVViiiissssuuuuaaaallll returns a pointer to an XVisualInfo structure describing
  28.      the visual that best meets a minimum specification.  The boolean GLX
  29.      attributes of the visual that is returned will match the specified
  30.      values, and the integer GLX attributes will meet or exceed the specified
  31.      minimum values. If all other attributes are equivalent, then TrueColor
  32.      and PseudoColor visuals have priority over DirectColor and StaticColor
  33.      visuals, respectively.  If no conforming visual exists, NNNNUUUULLLLLLLL is returned.
  34.      To free the data returned by this function, use XXXXFFFFrrrreeeeeeee.
  35.  
  36.      All boolean GLX attributes default to FFFFaaaallllsssseeee except GGGGLLLLXXXX____UUUUSSSSEEEE____GGGGLLLL, which
  37.      defaults to TTTTrrrruuuueeee.  All integer GLX attributes default to zero.  Default
  38.      specifications are superseded by attributes included in _a_t_t_r_i_b_L_i_s_t.
  39.      Boolean attributes included in _a_t_t_r_i_b_L_i_s_t are understood to be TTTTrrrruuuueeee.
  40.      Integer attributes and enumerated type attributes are followed
  41.      immediately by the corresponding desired or minimum value.  The list must
  42.      be terminated with NNNNoooonnnneeee.
  43.  
  44.      The interpretations of the various GLX visual attributes are as follows:
  45.  
  46.      GGGGLLLLXXXX____UUUUSSSSEEEE____GGGGLLLL            Ignored.  Only visuals that can be rendered with
  47.                            GLX are considered.
  48.  
  49.      GGGGLLLLXXXX____BBBBUUUUFFFFFFFFEEEERRRR____SSSSIIIIZZZZEEEE       Must be followed by a nonnegative integer that
  50.                            indicates the desired color index buffer size.  The
  51.                            smallest index buffer of at least the specified
  52.                            size is preferred.  Ignored if GGGGLLLLXXXX____RRRRGGGGBBBBAAAA is
  53.                            asserted.
  54.  
  55.      GGGGLLLLXXXX____LLLLEEEEVVVVEEEELLLL             Must be followed by an integer buffer-level
  56.                            specification.  This specification is honored
  57.                            exactly.  Buffer level zero corresponds to the main
  58.                            frame buffer of the display.  Buffer level one is
  59.                            the first overlay frame buffer, level two the
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllXXXXCCCChhhhoooooooosssseeeeVVVViiiissssuuuuaaaallll((((3333GGGG))))         OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee ---- GGGGLLLLXXXX         ggggllllXXXXCCCChhhhoooooooosssseeeeVVVViiiissssuuuuaaaallll((((3333GGGG))))
  71.  
  72.  
  73.  
  74.                            second overlay frame buffer, and so on.  Negative
  75.                            buffer levels correspond to underlay frame buffers.
  76.  
  77.      GGGGLLLLXXXX____RRRRGGGGBBBBAAAA              If present, only TrueColor and DirectColor visuals
  78.                            are considered.  Otherwise, only PseudoColor and
  79.                            StaticColor visuals are considered.
  80.  
  81.      GGGGLLLLXXXX____DDDDOOOOUUUUBBBBLLLLEEEEBBBBUUUUFFFFFFFFEEEERRRR      If present, only double-buffered visuals are
  82.                            considered.   Otherwise, only single-buffered
  83.                            visuals are considered.
  84.  
  85.      GGGGLLLLXXXX____SSSSTTTTEEEERRRREEEEOOOO            If present, only stereo visuals are considered.
  86.                            Otherwise, only monoscopic visuals are considered.
  87.  
  88.      GGGGLLLLXXXX____AAAAUUUUXXXX____BBBBUUUUFFFFFFFFEEEERRRRSSSS       Must be followed by a nonnegative integer that
  89.                            indicates the desired number of auxiliary buffers.
  90.                            Visuals with the  smallest number of auxiliary
  91.                            buffers that meets or exceeds the specified number
  92.                            are preferred.
  93.  
  94.      GGGGLLLLXXXX____RRRREEEEDDDD____SSSSIIIIZZZZEEEE          Must be followed by a nonnegative minimum size
  95.                            specification.  If this value is zero, the smallest
  96.                            available red buffer is preferred.  Otherwise, the
  97.                            largest available red buffer of at least the
  98.                            minimum size is preferred.
  99.  
  100.      GGGGLLLLXXXX____GGGGRRRREEEEEEEENNNN____SSSSIIIIZZZZEEEE        Must be followed by a nonnegative minimum size
  101.                            specification.  If this value is zero, the smallest
  102.                            available green buffer is preferred.  Otherwise,
  103.                            the largest available green buffer of at least the
  104.                            minimum size is preferred.
  105.  
  106.      GGGGLLLLXXXX____BBBBLLLLUUUUEEEE____SSSSIIIIZZZZEEEE         Must be followed by a nonnegative minimum size
  107.                            specification.  If this value is zero, the smallest
  108.                            available blue buffer is preferred.  Otherwise, the
  109.                            largest available blue buffer of at least the
  110.                            minimum size is preferred.
  111.  
  112.      GGGGLLLLXXXX____AAAALLLLPPPPHHHHAAAA____SSSSIIIIZZZZEEEE        Must be followed by a nonnegative minimum size
  113.                            specification.  If this value is zero, the smallest
  114.                            available alpha buffer is preferred.  Otherwise,
  115.                            the largest available alpha buffer of at least the
  116.                            minimum size is preferred.
  117.  
  118.      GGGGLLLLXXXX____DDDDEEEEPPPPTTTTHHHH____SSSSIIIIZZZZEEEE        Must be followed by a nonnegative minimum size
  119.                            specification.  If this value is zero, visuals with
  120.                            no depth buffer are preferred.  Otherwise, the
  121.                            largest available depth buffer of at least the
  122.                            minimum size is preferred.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ggggllllXXXXCCCChhhhoooooooosssseeeeVVVViiiissssuuuuaaaallll((((3333GGGG))))         OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee ---- GGGGLLLLXXXX         ggggllllXXXXCCCChhhhoooooooosssseeeeVVVViiiissssuuuuaaaallll((((3333GGGG))))
  137.  
  138.  
  139.  
  140.      GGGGLLLLXXXX____SSSSTTTTEEEENNNNCCCCIIIILLLL____SSSSIIIIZZZZEEEE      Must be followed by a nonnegative integer that
  141.                            indicates the desired number of stencil bitplanes.
  142.                            The smallest stencil buffer of at least the
  143.                            specified size is preferred.  If the desired value
  144.                            is zero, visuals with no stencil buffer are
  145.                            preferred.
  146.  
  147.      GGGGLLLLXXXX____AAAACCCCCCCCUUUUMMMM____RRRREEEEDDDD____SSSSIIIIZZZZEEEE    Must be followed by a nonnegative minimum size
  148.                            specification.  If this value is zero, visuals with
  149.                            no red accumulation buffer are preferred.
  150.                            Otherwise, the largest possible red accumulation
  151.                            buffer of at least the minimum size is preferred.
  152.  
  153.      GGGGLLLLXXXX____AAAACCCCCCCCUUUUMMMM____GGGGRRRREEEEEEEENNNN____SSSSIIIIZZZZEEEE  Must be followed by a nonnegative minimum size
  154.                            specification.  If this value is zero, visuals with
  155.                            no green accumulation buffer are preferred.
  156.                            Otherwise, the largest possible green accumulation
  157.                            buffer of at least the minimum size is preferred.
  158.  
  159.      GGGGLLLLXXXX____AAAACCCCCCCCUUUUMMMM____BBBBLLLLUUUUEEEE____SSSSIIIIZZZZEEEE   Must be followed by a nonnegative minimum size
  160.                            specification.  If this value is zero, visuals with
  161.                            no blue accumulation buffer are preferred.
  162.                            Otherwise, the largest possible blue accumulation
  163.                            buffer of at least the minimum size is preferred.
  164.  
  165.      GGGGLLLLXXXX____AAAACCCCCCCCUUUUMMMM____AAAALLLLPPPPHHHHAAAA____SSSSIIIIZZZZEEEE  Must be followed by a nonnegative minimum size
  166.                            specification.  If this value is zero, visuals with
  167.                            no alpha accumulation buffer are preferred.
  168.                            Otherwise, the largest possible alpha accumulation
  169.                            buffer of at least the minimum size is preferred.
  170.  
  171.      GGGGLLLLXXXX____SSSSAAAAMMMMPPPPLLLLEEEE____BBBBUUUUFFFFFFFFEEEERRRRSSSS____SSSSGGGGIIIISSSS
  172.                            Must be followed by the minimum acceptable number
  173.                            of multisample buffers.  Visuals with the smallest
  174.                            number of multisample buffers that meet or exceed
  175.                            this minimum number are preferred.  Currently
  176.                            operation with more than one multisample buffer is
  177.                            undefined, so the returned value will be either
  178.                            zero or one.  Note that multisampling is supported
  179.                            only on RealityEngine.
  180.  
  181.      GGGGLLLLXXXX____SSSSAAAAMMMMPPPPLLLLEEEESSSS____SSSSGGGGIIIISSSS      Must be followed by the minimum number of samples
  182.                            required in multisample buffers.  Visuals with the
  183.                            smallest number of samples that meet or exceed the
  184.                            specified minimum number are preferred.  Note that
  185.                            it is possible for color samples in the multisample
  186.                            buffer to have fewer bits than colors in the main
  187.                            color buffers.  However, multisampled colors
  188.                            maintain at least as much color resolution in
  189.                            aggregate as the main color buffers.
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. ggggllllXXXXCCCChhhhoooooooosssseeeeVVVViiiissssuuuuaaaallll((((3333GGGG))))         OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee ---- GGGGLLLLXXXX         ggggllllXXXXCCCChhhhoooooooosssseeeeVVVViiiissssuuuuaaaallll((((3333GGGG))))
  203.  
  204.  
  205.  
  206.      GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____TTTTYYYYPPPPEEEE____EEEEXXXXTTTT
  207.                            Must be followed by one of GGGGLLLLXXXX____NNNNOOOONNNNEEEE____EEEEXXXXTTTT,
  208.                            GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____RRRRGGGGBBBB____EEEEXXXXTTTT, GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____IIIINNNNDDDDEEEEXXXX____EEEEXXXXTTTT.
  209.                            If GGGGLLLLXXXX____NNNNOOOONNNNEEEE____EEEEXXXXTTTT is specified, then only opaque
  210.                            visuals will be considered; if
  211.                            GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____RRRRGGGGBBBB____EEEEXXXXTTTT is specified, then only
  212.                            transparent, RGBA visuals will be considered; if
  213.                            GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____IIIINNNNDDDDEEEEXXXX____EEEEXXXXTTTT is specified, then only
  214.                            transparent, indexed visuals will be considered.
  215.                            If not specified, the value GGGGLLLLXXXX____NNNNOOOONNNNEEEE____EEEEXXXXTTTT is used.
  216.  
  217.      GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____IIIINNNNDDDDEEEEXXXX____VVVVAAAALLLLUUUUEEEE____EEEEXXXXTTTT
  218.                            Must be followed by an integer value indicating the
  219.                            transparent index value; the value must be between
  220.                            0 and the maximum framebuffer value for indices.
  221.                            Only visuals that use the specified transparent
  222.                            index value will be considered.
  223.  
  224.                            This attribute is ignored during visual selection
  225.                            unless it is explicitly specified and
  226.                            GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____TTTTYYYYPPPPEEEE____EEEEXXXXTTTT is specified as
  227.                            GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____IIIINNNNDDDDEEEEXXXX____EEEEXXXXTTTT.
  228.  
  229.      GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____RRRREEEEDDDD____VVVVAAAALLLLUUUUEEEE____EEEEXXXXTTTT
  230.                            Must be followed by an integer value indicating the
  231.                            transparent red value; the value must be between 0
  232.                            and the maximum framebuffer value for red.  Only
  233.                            visuals that use the specified transparent red
  234.                            value will be considered.
  235.  
  236.                            This attribute is ignored during visual selection
  237.                            unless it is explicitly specified and
  238.                            GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____TTTTYYYYPPPPEEEE____EEEEXXXXTTTT is specified as
  239.                            GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____RRRRGGGGBBBB____EEEEXXXXTTTT.
  240.  
  241.      GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____GGGGRRRREEEEEEEENNNN____VVVVAAAALLLLUUUUEEEE____EEEEXXXXTTTT
  242.                            Must be followed by an integer value indicating the
  243.                            transparent green value; the value must be between
  244.                            0 and the maximum framebuffer value for green.
  245.                            Only visuals that use the specified transparent
  246.                            green value will be considered.
  247.  
  248.                            This attribute is ignored during visual selection
  249.                            unless it is explicitly specified and
  250.                            GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____TTTTYYYYPPPPEEEE____EEEEXXXXTTTT is specified as
  251.                            GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____RRRRGGGGBBBB____EEEEXXXXTTTT.
  252.  
  253.      GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____BBBBLLLLUUUUEEEE____VVVVAAAALLLLUUUUEEEE____EEEEXXXXTTTT
  254.                            Must be followed by an integer value indicating the
  255.                            transparent blue value; the value must be between 0
  256.                            and the maximum framebuffer value for blue.  Only
  257.                            visuals that use the specified transparent blue
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. ggggllllXXXXCCCChhhhoooooooosssseeeeVVVViiiissssuuuuaaaallll((((3333GGGG))))         OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee ---- GGGGLLLLXXXX         ggggllllXXXXCCCChhhhoooooooosssseeeeVVVViiiissssuuuuaaaallll((((3333GGGG))))
  269.  
  270.  
  271.  
  272.                            value will be considered.
  273.  
  274.                            This attribute is ignored during visual selection
  275.                            unless it is explicitly specified and
  276.                            GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____TTTTYYYYPPPPEEEE____EEEEXXXXTTTT is specified as
  277.                            GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____RRRRGGGGBBBB____EEEEXXXXTTTT.
  278.  
  279.      GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____AAAALLLLPPPPHHHHAAAA____VVVVAAAALLLLUUUUEEEE____EEEEXXXXTTTT
  280.                            Must be followed by an integer value.  This
  281.                            attribute is always ignored; it is for future use
  282.                            only.
  283.  
  284.      GGGGLLLLXXXX____VVVVIIIISSSSUUUUAAAALLLL____CCCCAAAAVVVVEEEEAAAATTTT____EEEEXXXXTTTT Must be followed by one of GGGGLLLLXXXX____NNNNOOOONNNNEEEE____EEEEXXXXTTTT,
  285.                            GGGGLLLLXXXX____SSSSLLLLOOOOWWWW____VVVVIIIISSSSUUUUAAAALLLL____EEEEXXXXTTTT, GGGGLLLLXXXX____NNNNOOOONNNN____CCCCOOOONNNNFFFFOOOORRRRMMMMAAAANNNNTTTT____EEEEXXXXTTTT.  If
  286.                            GGGGLLLLXXXX____NNNNOOOONNNNEEEE____EEEEXXXXTTTT is specified, then only visuals with
  287.                            no caveats will be considered; if
  288.                            GGGGLLLLXXXX____SSSSLLLLOOOOWWWW____VVVVIIIISSSSUUUUAAAALLLL____EEEEXXXXTTTT, is specified then only slow
  289.                            visuals will be considered; if
  290.                            GGGGLLLLXXXX____NNNNOOOONNNN____CCCCOOOONNNNFFFFOOOORRRRMMMMAAAANNNNTTTT____EEEEXXXXTTTT is specified then only non-
  291.                            conformant visuals will be considered.
  292.  
  293.                            This attribute is ignored during visual selection
  294.                            unless it is explicitly specified.
  295.  
  296.      GGGGLLLLXXXX____XXXX____VVVVIIIISSSSUUUUAAAALLLL____TTTTYYYYPPPPEEEE____EEEEXXXXTTTT Must be followed by one of GGGGLLLLXXXX____TTTTRRRRUUUUEEEE____CCCCOOOOLLLLOOOORRRR____EEEEXXXXTTTT,
  297.                            GGGGLLLLXXXX____DDDDIIIIRRRREEEECCCCTTTT____CCCCOOOOLLLLOOOORRRR____EEEEXXXXTTTT, GGGGLLLLXXXX____PPPPSSSSEEEEUUUUDDDDOOOO____CCCCOOOOLLLLOOOORRRR____EEEEXXXXTTTT,
  298.                            GGGGLLLLXXXX____SSSSTTTTAAAATTTTIIIICCCC____CCCCOOOOLLLLOOOORRRR____EEEEXXXXTTTT, GGGGLLLLXXXX____GGGGRRRRAAAAYYYY____SSSSCCCCAAAALLLLEEEE____EEEEXXXXTTTT,
  299.                            GGGGLLLLXXXX____SSSSTTTTAAAATTTTIIIICCCC____GGGGRRRRAAAAYYYY____EEEEXXXXTTTT, indicating the desired X
  300.                            visual type.
  301.  
  302.                            If GGGGLLLLXXXX____RRRRGGGGBBBBAAAA is in _a_t_t_r_i_b_L_i_s_t, then only
  303.                            GGGGLLLLXXXX____TTTTRRRRUUUUEEEE____CCCCOOOOLLLLOOOORRRR____EEEEXXXXTTTT and GGGGLLLLXXXX____DDDDIIIIRRRREEEECCCCTTTT____CCCCOOOOLLLLOOOORRRR____EEEEXXXXTTTT can
  304.                            produce a match. If GGGGLLLLXXXX____XXXX____VVVVIIIISSSSUUUUAAAALLLL____TTTTYYYYPPPPEEEE____EEEEXXXXTTTT is not in
  305.                            _a_t_t_r_i_b_L_i_s_t, and if all other attributes are
  306.                            equivalent, then a TTTTrrrruuuueeeeCCCCoooolllloooorrrr visual will be chosen
  307.                            in preference to a DDDDiiiirrrreeeeccccttttCCCCoooolllloooorrrr visual.
  308.  
  309.                            If GGGGLLLLXXXX____RRRRGGGGBBBBAAAA is not in _a_t_t_r_i_b_L_i_s_t, then only
  310.                            GGGGLLLLXXXX____PPPPSSSSEEEEUUUUDDDDOOOO____CCCCOOOOLLLLOOOORRRR____EEEEXXXXTTTT and GGGGLLLLXXXX____SSSSTTTTAAAATTTTIIIICCCC____CCCCOOOOLLLLOOOORRRR____EEEEXXXXTTTT can
  311.                            produce a match. If GGGGLLLLXXXX____XXXX____VVVVIIIISSSSUUUUAAAALLLL____TTTTYYYYPPPPEEEE____EEEEXXXXTTTT is not in
  312.                            _a_t_t_r_i_b_L_i_s_t, and if all other attributes are
  313.                            equivalent, then a PPPPsssseeeeuuuuddddooooCCCCoooolllloooorrrr visual will be
  314.                            chosen in preference to a SSSSttttaaaattttiiiiccccCCCCoooolllloooorrrr visual.
  315.  
  316.                            The tokens GGGGLLLLXXXX____GGGGRRRRAAAAYYYY____SSSSCCCCAAAALLLLEEEE____EEEEXXXXTTTT and
  317.                            GGGGLLLLXXXX____SSSSTTTTAAAATTTTIIIICCCC____GGGGRRRRAAAAYYYY____EEEEXXXXTTTT will not match current OpenGL
  318.                            enabled visuals, but are included for future use.
  319.  
  320. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  321.      _a_t_t_r_i_b_L_i_s_t =
  322.                  {GGGGLLLLXXXX____RRRRGGGGBBBBAAAA, GGGGLLLLXXXX____RRRREEEEDDDD____SSSSIIIIZZZZEEEE, 4, GGGGLLLLXXXX____GGGGRRRREEEEEEEENNNN____SSSSIIIIZZZZEEEE, 4, GGGGLLLLXXXX____BBBBLLLLUUUUEEEE____SSSSIIIIZZZZEEEE,
  323.                  4, NNNNoooonnnneeee};
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. ggggllllXXXXCCCChhhhoooooooosssseeeeVVVViiiissssuuuuaaaallll((((3333GGGG))))         OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee ---- GGGGLLLLXXXX         ggggllllXXXXCCCChhhhoooooooosssseeeeVVVViiiissssuuuuaaaallll((((3333GGGG))))
  335.  
  336.  
  337.  
  338.      Specifies a single-buffered RGB visual in the normal frame buffer, not an
  339.      overlay or underlay buffer.  The returned visual supports at least four
  340.      bits each of red, green, and blue, and possibly no bits of alpha.  It
  341.      does not support color index mode, double-buffering, or stereo display.
  342.      It may or may not have one or more auxiliary color buffers, a depth
  343.      buffer, a stencil buffer, or an accumulation buffer.
  344.  
  345. NNNNOOOOTTTTEEEESSSS
  346.      XXXXVVVViiiissssuuuuaaaallllIIIInnnnffffoooo is defined in _X_u_t_i_l._h.  It is a structure that includes
  347.      _v_i_s_u_a_l, _v_i_s_u_a_l_I_D, _s_c_r_e_e_n, and _d_e_p_t_h elements.
  348.  
  349.      ggggllllXXXXCCCChhhhoooooooosssseeeeVVVViiiissssuuuuaaaallll is implemented as a client-side utility using only
  350.      XXXXGGGGeeeettttVVVViiiissssuuuuaaaallllIIIInnnnffffoooo and ggggllllXXXXGGGGeeeettttCCCCoooonnnnffffiiiigggg.  Calls to these two routines can be used
  351.      to implement selection algorithms other than the generic one implemented
  352.      by ggggllllXXXXCCCChhhhoooooooosssseeeeVVVViiiissssuuuuaaaallll.
  353.  
  354.      GLX implementers are strongly discouraged, but not proscribed, from
  355.      changing the selection algorithm used by ggggllllXXXXCCCChhhhoooooooosssseeeeVVVViiiissssuuuuaaaallll.  Therefore,
  356.      selections may change from release to release of the client-side library.
  357.  
  358.      There is no direct filter for picking only visuals that support
  359.      GLXPixmaps.  GLXPixmaps are supported for visuals whose GGGGLLLLXXXX____BBBBUUUUFFFFFFFFEEEERRRR____SSSSIIIIZZZZEEEE
  360.      is one of the pixmap depths supported by the X server.
  361.  
  362.      GGGGLLLLXXXX____SSSSAAAAMMMMPPPPLLLLEEEE____BBBBUUUUFFFFFFFFEEEERRRRSSSS____SSSSGGGGIIIISSSS and GGGGLLLLXXXX____SSSSAAAAMMMMPPPPLLLLEEEESSSS____SSSSGGGGIIIISSSS are not valid attributes
  363.      unless the SSSSGGGGIIIISSSS____mmmmuuuullllttttiiiissssaaaammmmpppplllleeee extension is supported.
  364.  
  365.      GGGGLLLLXXXX____XXXX____VVVVIIIISSSSUUUUAAAALLLL____TTTTYYYYPPPPEEEE____EEEEXXXXTTTT, GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____TTTTYYYYPPPPEEEE____EEEEXXXXTTTT,
  366.      GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____IIIINNNNDDDDEEEEXXXX____VVVVAAAALLLLUUUUEEEE____EEEEXXXXTTTT, GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____RRRREEEEDDDD____VVVVAAAALLLLUUUUEEEE____EEEEXXXXTTTT,
  367.      GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____GGGGRRRREEEEEEEENNNN____VVVVAAAALLLLUUUUEEEE____EEEEXXXXTTTT, GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____BBBBLLLLUUUUEEEE____VVVVAAAALLLLUUUUEEEE____EEEEXXXXTTTT, and
  368.      GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____AAAALLLLPPPPHHHHAAAA____VVVVAAAALLLLUUUUEEEE____EEEEXXXXTTTT are not valid attributes unless the
  369.      EEEEXXXXTTTT____vvvviiiissssuuuuaaaallll____iiiinnnnffffoooo extension is supported.
  370.  
  371.      GGGGLLLLXXXX____VVVVIIIISSSSUUUUAAAALLLL____CCCCAAAAVVVVEEEEAAAATTTT____EEEEXXXXTTTT is not a valid attribute unless the
  372.      EEEEXXXXTTTT____vvvviiiissssuuuuaaaallll____rrrraaaattttiiiinnnngggg extension is supported.
  373.  
  374.  
  375. EEEERRRRRRRROOOORRRRSSSS
  376.      NNNNUUUULLLLLLLL is returned if an undefined GLX attribute is encountered in
  377.      _a_t_t_r_i_b_L_i_s_t.
  378.  
  379.  
  380.  
  381. MMMMAAAACCCCHHHHIIIINNNNEEEE DDDDEEEEPPPPEEEENNNNDDDDEEEENNNNCCCCIIIIEEEESSSS
  382.      The SSSSGGGGIIIISSSS____mmmmuuuullllttttiiiissssaaaammmmpppplllleeee extension is supported only on RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee,
  383.      RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee2222, and VVVVTTTTXXXX systems and IIIInnnnffffiiiinnnniiiitttteeeeRRRReeeeaaaalllliiiittttyyyy systems.
  384.  
  385.  
  386. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  387.      ggggllllXXXXCCCCrrrreeeeaaaatttteeeeCCCCoooonnnntttteeeexxxxtttt, ggggllllXXXXGGGGeeeettttCCCCoooonnnnffffiiiigggg
  388.  
  389.  
  390.  
  391.  
  392.  
  393.                                                                         PPPPaaaaggggeeee 6666
  394.  
  395.  
  396.  
  397.